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IMPORTANT: If your new Release 5.2 diskette will not boot up in your 
computer, read the section of this addendum on the MOVER 
program. You may need to use that program first. 

This addendum describes the new features which have been added to 
North Star System Software since Release 5.0, which is described in 
Revision 2.1 of the SYSTEM SOFTWARE MANUAL. 

SYSTEM SOFTWARE. MAN A L_ E R R_A T A 

Before proceeding, please make the following changes to the manual: 

1 . On page A-2 of the DOS section, file directory entry bytes 
10-11 are described as, "number of blocks in file", but 
should be described as, "number of sectors in file". 

2. On page G-2 of the DOS section, one of the comments before 
DCOM reads, "ACC=NUMBER OF BLOCKS". It should read, 
"ACC=NUMBER OF SECTORS". 

3. After a call to DCOM, the stack pointer will be left 
unchanged whether DCOM exitted via the return address on the 
stack or via the HDERR vector. If this information might 
ever be useful to you, please make a note of it on page G-2 
of the DOS section. 

4. When performing DOS personalization, it is important to note 
that DOS 5.2DQ loads in two parts: 



Sectors 4-8 load into 100H-AFFH 
Sectors 8-9 load into A00H-DFFH 



(assuming normal origin) 



For example, if the personalization begins by typing "LF DOS 
4000", then an 1/0 subroutine destined to be loaded at 
2934H, or at 0A34H, will be found at 4834H, and a turnkey 
command string destined to be loaded at 2A55H, or at 0B55H, 
will be found at 4955H. Please make a note of this on page 
F-2 of the DOS section. 

NEW FE ATURES I N RELEASE 5.2 

This section of this addendum describes the new features which 
were added with Release 5.2. This information is presented 
separately for the convenience of current users of the preceding 
release of the software. 



As before, there are two versions of Release 5.2. One version, 5.2S, 
is for use with the older, single-density systems only. The other 



version, 5.2DQ, is for use with 
only. The DOS's for these 
because they operate different 
differences are noted below, 
independent of the type 
double-density/quad) on which it 



double-density and quad systems, 
two systems are quite different 
disk hardware, and some of the 
But the remainder of the software is 
of system (single-density or 
is used. 



25501E 



ADDENDUM, SYSTEM SOFTWARE MANUAL, 7/11/80 (continued) 2 



"MOVER" RELOCATION PROGRAM 

The MOVER program provides a simple method for relocating DOS, 
BASIC, and other programs, to special starting addresses. This 
procedure can be easily performed directly by the dealer or end 
user. (Special relocated versions of DOS and BASIC will no longer 
be available from North Star.) 



In order to provide this 
5.2 software diskette 



program relocation capability, the Release 
includes the MOVER program and a series of 




Programs on the software diskette are relocated by LOADing and 
RUNning the MOVER program under BASIC. When MOVER is run, it will 
make requests for relocation information on the console terminal. 
Then, it will sequentially attempt to relocate each program on the 
diskette for which a relocation key file exists. 

If the relocation of a program on the diskette is not desired, the 
corresponding relocation key file should be deleted from the 
diskette before MOVER is run. 

WARNING: In order to save space, both in memory, and on the disk, 
this MOVER program writes the newly generated, relocated 
program into the same files from which the relocation key 
information is taken. This can only be done once. 
Therefore, it is very important that this only be done to 
diskette copies made from the Factory Master diskette, and 
never to the original Factory Master diskette, itself. 

It may be necessary to use the MOVER program before any of the other 
new programs can be used at all. This will be the case in a system 
with a nonstandard bootstrap PROM set. This will also be the case in 
a double-density or quad system with no memory below 2000H, because 
the DOS, as supplied for these systems, loads at 100H. In these 
cases, MOVER should be run under an earlier release of North Star 
BASIC. 



After the relocation is completed, and before the newly generated 
software can be used, it will be necessary to copy the new DOS into 
the first file position (sector 4) of a diskette, where it can be 
loaded by the bootstrap PROM. It might be appropriate to copy all of 
the relocated software to another diskette, starting with the DOS. 

When using MOVER, it is possible to supply relocation information 
which leads to unreasonable or meaningless program relocations. In 
such cases, MOVER will cause either an OUT OF BOUNDS ERROR or the 
generation of unusable software (such as with DOS and BASIC 
overlapping). When this happens, do not be alarmed. Just recopy the 
diskette and repeat the process until you are completely satisfied 
with the results. Some of the mistakes which are expected to be the 
most common are described below. 
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The utlities are always followed in RAM by large areas (5 to 5.5 K) 
which are used for disk buffers. Like the programs, these areas may 
not wrap around the end of memory. Therefore, an attempt to locate 
the utilities above the space occupied by the standard disk 

controller ( E800K-EBFFK ) will fail. 

As mentioned above, the MOVER works by comparing the relocation key 
files with the corresponding standard files on the same disk. 
Therefore, if one of the standard files has been personalized or 
otherwise altered, it will not relocate properly. 

When an error occurs during the relocation of one of the files, the 
first part of the relocation key file will have been overwritten, 
but its type will still be 3. This file should be recopied from the 
master diskette right away. If instead MOVER is run again, it will 
attempt to use the overwritten portion of this file as relocation 
key data. This could produce very obscure results. 
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Interrupts During Disk Transfers 

Interrupts are now disabled during disk transfers and conditionally 
reenabled when permissable. Bit 7 of the RWCHK flag byte now 
controls this feature, while bit of the same byte continues to 
control the read-after- write check. Interrupts will be left enabled 
after disk operations if and only if bit 7 has been set to one. This 
does not permit interrupts to serve as effectively as the OFTEN call 
for such things as type ahead, software clocks, or modem service 
because of the length of time that they must be disabled. But for 
extremely rare events, such as RAM parity errors, they may be 
appropriate . 
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Parity Error s 

A routine is provided, when the DOS is personalized for the Horizon, 
which prints a message at the console if a memory failure is ever 
detected. To enable this feature, the RAM boards should be set to 
generate vectored interrupt five and the interrupt control flag, bit 
7 of RWCHK, in the working copy of the DOS should be set to one. If 
the message, "RAM PARITY ERROR," appears on the terminal, you may 
press RETURN to continue with the parity check disarmed or press any 



other key 
drive one ) . 



to reboot (after putting the appropriate diskette into 



DLOOK Error Return 

The library routine, DLOOK, now returns a zero in the accumulator if 
an error was detected in the syntax of the specified filename. 
Otherwise, it returns the implied drive number, as it did in earlier 
releases . 



Disk Controller Address 

There is now a byte in the jump table at 203AH or 1 3 AH , which 
indicates the origin of the disk controller. This information is 
provided for use by any program which may need to access the disk 
controller directly, such as to reboot the system by branching to 
the address of the bootstrap PROM. 



DOS FOR DOUBLE-DENSITY AND QUAD 

Speed Improvement 

The low level reading and writing routines in the DOS have been 
modified for an increase in overall throughput. Some speed 
improvements will be noticed during copy operations and during 
extensive access to data files. 



CK UTILITY 



The CK Utility provides an easy way for the dealer or end user to 
verify that the contents of a Factory Master diskette are precisely 
correct, and have not been corrupted or accidentally changed, 
after leaving the factory. Running this utility computes an overall 
check code for an entire diskette. The number it displays can then 
be compared against the correct check value for any standard 
diskette, as given below. If the check value does not compare 
correctly, then the diskette should be replaced with a correct 
diskette. 
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The correct check values for the four standard diskettes are 

Name Part Num ber Check V alue 

HORIZON-S 11002C 21516 

HORIZON-DQ 1 1 001 B 58777 

MDS-S 11008C 5M115 

MDS-DQ 11007B 38179 



BASIC 

Longer Ma ximum Line Length and Suppression of Automatic Carriage Returns 
The LINE statement can now be used to set the line length for any 
device to as much as 165 characters. This statement will also now 
accept an optional, additional argument, which must be a numeric 
expression preceded by a comma. If this expression evaluates to 
zero, BASIC will stop automatically sending carriage returns and 
line feeds to the specified ou tput device whenever its line length 
is reached. If the expression evaluates to a non-zero value, 
automatic generation of carriage returns and line feeds will be 
resumed on the specified device. This feature may be useful when 
sending something other than normal text to an output device. 

File Siz e Function 

A new function, FILESIZE(N), returns the size in blocks of a 

currently open file specified by the numeric expression, N. 

File Poi nter F unctio n 

Similarly, another new function, FILEPTR(N), returns the current 
position of the file pointer in currently open file, N. This 
function may be useful in the numeric expression which specifies the 
new position in a file for a random READ or WRITE statement. 

File Pointer Posi t ioning 

A WRITE statement of the following form: 

WRITE #N $P, NOENDMARK 

will set the file pointer in any currently open file N, to any valid 
position P, for a subsequent sequential READ or WRITE statement. 
This statement may be used to reset a file pointer to zero without 
closing and reopening the file. 



RAMTEST 

Two copies of a new memory test program are provided, which occupy 
different areas of memory so that all of memory can be tested. This 
test is designed for use in Horizons only, requires a Z-80 
processor, and does all of its I/O through the Horizon's standard 
serial port. 



ADDENDUM, SYSTEM SOFTWARE MANUAL, 7/11/80 (continued) 6 



64 



8 



RAMTEST always tests memory in 1K regions. It maintains 

matrix of memory error status. Whenever this matrix is typed out, 

the 64 characters per line represent the 64K address space, left to 

right, starting at zero. The line for bit is typed first, the line 

for bit 7 last. The error matrix is cumulative. This means that once 

a bit is marked bad, it will not be marked good by subsequent 

passes. 



Phase is only performed once. It makes a quick judgment of the 
status of the memory system by testing only the first byte of each 
region. It then types the error matrix, with entries meaning: 

M = RAM memory 

- = no memory 

P = PROM or ROM 

* = region reserved for test program 
On subsequent passes only the n M n regions are tested. Errors change 
the n M" to "?". 

Phase 1 tests with a pattern of all zeroes. 

Phase 2 tests with a pattern of all ones. 

Phase 3 tests with a fixed pattern of 19 bytes repeated for the 

entire region. The test is done 38 times, with each byte of the 

pattern getting to be first, and incrementing memory both forward 
and backward. 

Phase 4 tests with a pattern calculated to stress address buffers. 



Phase 5 tests that 
all other n M n , "-" 



a data pattern in each 
or n P" regions. 



region survives stores to 



Phase 6 tests with an algorithm calculated to stress the ability of 
dynamic RAM cells to retain information in the face of noise in 
adjacent cells. 

Phase n M n tests the ability of each region to execute programs. 
First a subroutine of 1023 NOP's and a RET is called several times. 
Next, a program calculated to create electrical noise is called, 
which moves itself about while performing calculatons. If the 
correct answer is returned, an n M" is typed. If the wrong answer is 
returned, a "? n is typed. If the subroutine fails to return, most 
likely nothing is typed, leaving the terminal's cursor indicating 
the offending region. 



Phase "-" tests a memory board f s ability to fetch an opcode, operand 
sequence from different memory chips, testing that the first chip 
deselects properly. This phase is performed only on even numbered 
passes to ensure that the computer first executes all other numbered 
phases. 
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Each full pass begins by typing out a pass counter which runs from 
"AA" to "ZZ" and then repeats. The following character is an 
exclamation point if any errors have occurred since the test began, 
or a space otherwise. 

If a control C from the keyboard is detected (through the Horizon»s 
standard serial port), the program jumps to location E800h to 
reboot. If any other character is detected, the error matrix is 
typed. Thus evidence of a single error is not lost, even if it has 
scrolled off of a CRT terminal. 

The program assumes the presence of a North Star dual-density disk 
controller, which will generate wait states whenever location E916H 
is fetched. Obviously, the program will still run without wait 
states. A fetch of location E916H has no effect on a single-density 
controller. Wait states are used in phases 6 and "M". 

For North Star RAMS, parity control is output on port COH. Phase 
attempts to light the error LED if any byte had bad parity on 
entering the program. After phase 0, the LED should light only on 
the occurrence of an error. A scan for correct parity is also done 
at the end of each phase. A chip location diagram for North Star RAM 
boards is included at the end of this addendum. 



Z80 Horizon I/O Routines 

The I/O routines for Horizon computers supplied with Release 5.2 are 

written in Z80 code. This was done to make room for the parity 

message feature and to make it usable in systems which do not have 

RAM at zero. However, except for the RAMTEST, the remainder of the 

software on a Release 5.2 diskette is still entirely 8080 

compatible. 
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oooo 

0000 
0000 
0000 
0000 
0000 
0000 
0100 
0000 
0000 
0000 
E800 
0000 
0000 
0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0000 
0000 
0A00 
0107 
012B 
0000 
0000 
0000 
010D 
0110 
0113 
0116 
0119 
0119 
0119 
0119 
014: 

oi4: 

014 
014 

014: 

014 

oi4: 

014' 
014- 

014' 
014- 
014' 
014' 
014' 
014- 



C3DA0A 
C3500A 
C3880A 
C3F10A 



C33A0A 



♦I/O ROUTINES FOR -STANDARD HORIZON COMPUTER 



DOS 



PADDR 
BADDR 



PO 
PI 
P2 
P3 
P4 
P5 
P6 
P7 



IOBLK 
OFTEN 
RWCHK 



CIIO 
CHI 
INIT 
CON 



EQU 



EQU 
EQU 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



EQU 
EQU 
EQU 



ORG 
JMP 
JMP 
JMP 
JMP 



ORG 



0100H ; BASE ADDRESS OF DOS 



; BASE ADDRESS OF MOTHERBOARD I/O PORTS 
0E8 00H ; BASE ADDRESS OF DISK CONTROLLER 



; ADDRESSES OF MOTHERBOARD I/O PORTS 



PADDR+0 
PADDR+1 
PADDR+2 
PADDR+3 
PADDR+4 
PADDR+5 
PADDR+6 
PADDR+7 



DOS+900H 
DOS + 7 
DOS+2BH 



DOS+0DH 

COUT ; CHARACTER OUTPUT 
CIN ; CHARACTER INPUT 
TINIT ; INITIALIZATION 
CONTC ; CONTROL C CHECK 



DOS+41H 



THIS IS THE INPUT STATUS ROUTINE 
IT IS CALLED WITH THE DEVICE I IN A 
RETURNS NUMBER OF DEVICE TESTED IN A 
RETURNS Z FLAG TRUE IF INPUT DATA AVAILABLE 
NO OTHER REGISTERS MAY BE MODIFIED 
I STAT JMP 1ST 

THIS IS THE OUTPUT STATUS ROUTINE 

IT IS CALLED WITH THE DEVICE # IN A 

RETURNS NUMBER OF DEVICE TESTED IN A 

RETURNS Z FLAG TRUE IF OUTPUT DEVICE READY 

NO OTHER REGISTERS MAY BE MODIFIED 

I STAT AND OSTAT MAY BE USED BY SOFTWARE TO 

DETERMINE WHICH DEVICE NUMBERS ARE IMPLEMENTED 
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0144 
0147 
0147 
0147 
0147 
OA00 
0A00 
OAOO 
OAOO 
OACO 
OAOO 
OAOO 
OAOO 
OAOO 
0A01 
0A02 
0A03 
0A06 
0A06 
0AC7 
0A08 
0A09 
OAOC 
OACD 
OAOF 
0A12 
0A14 
0A16 
0A18 
0A1B 
0A1C 
0A1D 
0A1E 
0A1F 
0A20 
0A20 



0A35 
0A35 
0A3 5 
0A35 
0A35 
0A36 
0A39 
0A3A 
0A3A 
0A3C 
0A3E 
0A3E 
0A3E 
0A4 
0A41 



C3680A 



F5 
C5 
E5 
21200A 

46 
23 

AF 

CD0D01 

B7 

20F7 

CDI001 

FECD 

3E40 

D3C0 

C200E8 

El 

CI 

Fl 

FB 

C9 

OD0A5241 
4D205041 
52495459 
20455252 
4F522007 
00 



F5 

CD0701 

Fl 

FE01 
2808 



OSTAT JMP 



ORG 



OST 



IOBLK 



THE FOLLOWING ROUTINE IS CALLED IF A PARITY 
ERROR EVER OCCURS AND GENERATES AN INTERUPT. 
(PE JUMPERED TO VI5 ON THE RAM BOARD) 
IT GIVES THE USER AN OPPORTUNITY TO ATTEMPT TO 
CONTINUE PROCESSING BY PRESSING RETURN OR TO 
REBOOT BY STRIKING ANY OTHER KEY. 



PERR 



PERR1 



EQU 


$ 


PUSH 


PSW 


PUSH 


B 


PUSH 


H 


LXI 


H,ERTXT 


EQU 


$ 


MOV 


B,M 


I NX 


H 


XRA 


A 


CALL 


CHO 


ORA 


A 


JRNZ 


PERR1 


CALL 


CHI 


CPI 


13 


MVI 


A,40H 


OUT 


OCOH 


JNZ 


BADDR 


POP 


H 


POP 


B 


POP 


PSW 


EI 




RET 





ERTXT DB 



; POINT TO ERROR MESSAGE 



; SPECIFY OUTPUT DEVICE ZERO 
:SEND CHARACTER 
;TEST FOR TERMINATING NULL 

rGET RESPONSE FROM DEVICE ZERO 
;TEST FOR CARRIAGE RETURN 

;DISARM PARITY LOGIC 

; REBOOT UNLESS CHAR WAS CARRIAGE RETURN 



13, 10,' RAM PARITY ERROR ',7,0 



DB03 

2F 

E602 



OFIST EQU $ 

PUSH PSW 

CALL OFTEN 

POP PSW 

1ST EQU $ 

CPI 1 

JRZ IST1 

;* ASSUME DEVICE 

ISTO EQU $ 

IN P3 
CM A 
AN I 



; ALTERNATIVE ENTRY TO STATUS ROUTINE 
;SAVE DEVICE NUMBER 
;TAKE CARE OF BUSINESS 
/RESTORE DEVICE NUMBER 
; INPUT STATUS ROUTINE 

;TEST FOR DEVICE 1 POSSIBILITY 
;JUMP TO SECOND SERIAL PORT STATUS TEST 
INTENDED 



WAS 



; FIRST SERIAL STATUS PORT 
; INVERT STATUS FOR PROPER RESULT 
2 ;TEST RECEIVER DATA AVAILABLE BIT 
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0A43 
0A4 5 
0A46 
0A46 
0A46 
0A48 
0A49 
0A4B 
0A4D 
0A4E 
0A4E 
0A4E 
0A50 
0A50 
0A53 
0A55 
0A57 
0A59 
0A59 
0A59 
0A5B 
0A5D 
0A5E 
0A5E 
0A5E 
0A60 
0A62 
0A63 
0A63 
0A63 
0A63 
0A64 
0A67 
0A68 
0A68 
0A6A 
0A6C 
0A6E 
0A7 
0A7 
0A7 
0A72 
0A73 
0A7 5 
0A77 
0A78 
0A78 
0A7 8 
0A7A 
0A7B 
0A7D 
0A7F 
0A8 
0A80 
0A80 
0A82 



3E00 
C9 



DB05 

2F 

E602 

3E01 

C9 



3E00 

CD3A0A 
20FB 
FE01 
2805 



DB02 
E67F 
C9 



DB04 
E67F 
C9 



F5 

CD0701 

Fl 

FE02 
2814 
FE01 
2808 



DB03 

2F 

E601 

3E00 

C9 



DB05 

2F 

E601 

3E01 

C9 



DB06 
2F 



MVI 
RET 

IST1 EQU 
IN 
CM A 

ANI 
MVI 
RET 

ZCIN EQU 
MVI 

CIN EQU 
CALL 
JRNZ 
CPI 
JRZ 

;* ASSUME PORT 

CINO EQU 
IN 
ANI 
RET 

CIN1 EQU 
IN 
ANI 
RET 



OFOST EQU 
PUSH 
CALL 
POP 

OST EQU 
CPI 
JRZ 
CPI 
JRZ 

;* ASSUME DEV 



A,0 ;SHOW WHICH DEVICE WAS TESTED 
; RETURN WITH INPUT STATUS IN Z FLAG 

$ 
P5 



2 
A,l 



$ .'ALTERNATIVE ENTRY TO CIN 

A,0 .-SUBSTITUTE FIXED DEVICE NUMBER 

$ .-CHARACTER INPUT ROUTINE 

1ST ;CHECK STATUS OF SPECIFIED DEVICE 

CIN ;LOOP UNTIL DATA AVAILABLE 

1 ;CHECK FOR DEVICE 1 POSSIBILITY 

CIN1 ;JUMP IF SECOND SERIAL PORT SPECIFIED 

(STANDARD SERIAL FORT) DESIRED 

$ 

P2 ; INPUT THE CHARACTER 

7FH ;MASK OFF PARITY BIT 

; RETURN WITH CHARACTR IN A 

$ 

P4 

7FH 



ALTERNATIVE ENTRY TO STATUS ROUTINE 

;SAVE DEVICE NUMBER 

,-TAKE CARE OF BUSINESS 
; RESTORE DEVICE NUMBER 

; OUTPUT STATUS ROUTINE 
;TEST FOR DEVICE 2 POSSIBILITY 
MUMP TO PARALLEL PORT STATUS TEST 
;TEST FOR DEVICE 1 POSSIBILITY 
.•JUMP TO SECOND SERIAL PORT STATUS TEST 

INTENDED 



OST0 



OST1 



OST2 



EQU 

IN 

CM A 

ANI 

MVI 

RET 

EQU 

IN 

CM A 

ANI 

MVI 

RET 

EQU 

IN 

CMA 



$ 

PSW 
OFTEN 
PSW 
$ 
2 

OST2 
1 

OST1 
ICE WAS 
$ 

P3 ; FIRST SERIAL STATUS PORT 

; INVERT STATUS FOR PROPER RESULT 
1 ,-TEST TRANSMITTER BUFFER EMPTY BIT 

A,0 ;SHOW WHICH DEVICE WAS TESTED 
,- RETURN WITH INPUT STATUS IN Z FLAG 

$ 
P5 

1 
A,l 



$ 

P6 
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0A8 3 


E601 


0A85 


3E02 


0A87 


C9 


0A88 




0A88 




0A88 




CASS 




0A8 


AF 


0A89 


D306 


CA8D 


D306 


0A8D 


D306 


0A8F 


D306 


0A91 


3ECE 


0A9 3 


D303 


0A9 5 


3ECE 


0A97 


D305 


0A99 


3E37 


0A9B 


D303 


0A9D 


3E37 


0A9F 


D305 


0AA1 




0AA1 




0AA1 




0AA1 




0AA1 


3E40 


0AA3 


D3C0 


0AA5 


2100E8 


0AA8 


54 


0AA9 


5D 


OAAA 


0101FC 


OAAD 


EDB8 


OAAF 


3C 


OABO 


D3C0 


0AB2 




0A32 


DB02 


0AB4 


DB04 


0AB6 




0AB6 




0AB6 


060D 


0AB6 


3A2B01 


OA'BB 


07 


OABC 


3007 


OABE 


3E0A 


OACO 


ED47 


0AC2 


ED5E 


0AC4 


FB 


0AC5 




0AC5 




0AC5 




0AC5 


3E20 


0AC7 


D306 


0AC9 


78 


OACA 


F680 


OACC 


D300 


OACE 


EE8 


OADO 


D300 



AN I 
MVI 
RET 



1 
A, 2 



TINIT EQU $ 

;* FIRST INITIALIZE MOTHERBOARD AND SET UP BOTH SERIAL PORTS 

;ZERO ACC 

.•INITIALIZE MOTHERBOARD 

; EXTRA 

; EXTRA 

; EXTRA 
;2 STOPS, 16xCL0CK, 8 BITS, NO PARITY 

;SEND TO FIRST SERIAL PORT 
;SAME CODE AS FIRST PORT 

; SECOND PORT 
;CMD: RTS, ER, RXF, DTR, TXEN 

; FIRST PORT 
;SAME CODE AS FIRST PORT 

; SECOND PORT 



*TINIT NEXT REWRITES ALL RAM TO SET PARITY CORRECT 



XRA 


A 


OUT 


P6 


OUT 


P6 


OUT 


P6 


OUT 


P6 


MVI 


A,0CEH 


OUT 


P3 


MVI 


A,0CEH 


OUT 


P5 


MVI 


A,37H 


OUT 


P3 


MVI 


A,37H 


OUT 


P5 



MVI 


A,40H 


OUT 


OCOH 


LXI 


H,BADDR 


MOV 


D,H 


MOV 


E,L 


LXI 


B,-1023 


LDDR 


;SET PA 


INR 


A 


OUT 


OCOH 


IN 


P2 


IN 


P4 



;DISABLE PARITY LOGIC 

; BEFORE READING UNWRITTEN RAM 
; FIRST BYTE TO CLEAR 



; NUMBER OF BYTES TO CLEAR 
ON ALL RAM 

;TO 41H, PARITY ENABLE CODE 
; REARM PARITY LOGIC 






; CLEAR STANDARD SERIAL PORT INPUT BUFFER 
;CLEAR SECOND SERIAL PORT INPUT BUFFER 



MVI B,13 ; CARRIAGE RETURN TO INIT PRINTER 

LDA RWCHK 

RLC ;TEST INTERUPT ENABLE FLAG 

JRNC COUT2 

MVI A,IOBLK/256 ;PAGE ADDRESS OF I/O BLOCK 

MOV IV, A 

IM 2 ;SET INTERUPT MODE TWO 

EI 



;*PRINTER PARALLEL OUTPUT ROUTINE 
COUT2 



EQU 


$ 


MVI 


A,20H 


OUT 


P6 


MOV 


A,B 


ORI 


8 OH 


OUT 


PO 


XRI 


8 OH 


OUT 


PO 



; RESET PO FLAG 

; CHARACTER TO SEND 

;SET STROBE FALSE 

;SEND CHARACTER 
; TOGGLE STROBE 
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0AD2 
0AD4 
0AD6 



OADD 
OADF 
OAE1 
0AE3 
0AE5 
0AE7 
0AE7 
0AE7 
0AE8 



EE80 
D300 
78 



3E00 



0AD7 C9 

0AD8 

0AD8 

0AD8 

0AD8 

OADA 

OADA CD680A 
20FB 
FE01 
2808 
FE02 
28DE 



78 
D302 



OAEA C9 

OAEB 

OAEB 

OAEB 78 

OAEC D304 

OAEE C9 

OAEF 

OAEF 

OAEF 

OAEF 

OAEF 

OAEF OOOA 

0AF1 

0AF1 

0AF1 3E00 

0AF3 CD3A0A 

0AF6 37 

0AF7 3F 

0AF8 CO 

0AF9 CD500A 

OAFC FE03 

OAFE 37 

OAFF C9 

OBOO 

SYMBOL TABLE 

BADDR E8 00 00 

CON 0116 01 

DOS 0100 00 

IST1 0A46 01 

OSTO 0A70 01 

P2 0002 00 

PADDR 0000 00 

ZCOUT 0AD8 01 



XRI 80H 

OUT PO 

MOV A,B 
RET 



;TOGGLE STROBE 

;GET CHARACTER FOR RETURN 



ZCOUT EQU $ 

MVI A,0 

COUT FQU $ 

CALL OST 

JRNZ COUT 

CPI 1 

JRZ C0UT1 

CPI 2 

JRZ C0UT2 
;*ASSUME STANDARD SERIAL PORT OUTPUT 

COUO EQU $ 

MOV A,B ;MOVE CHARACTER TO A 

OUT P2 ; OUTPUT THE CHARACTER 

RET 

COUT1 



ALTERNATIVE ENTRY TO COUT 

SUBSTITUTE FIXED DEVICE NUMBER 
.•CHARACTER OUTPUT ROUTINE 

;CHECK STATUS OF SPECIFIED DEVICE 

;LOOP UNTIL READY FOR DATA 

; SECOND SERIAL PORT OUTPUT 
; PARALLEL OPORT OUTPUT 



EQU 


$ 


MOV 


A,B 


OUT 


P4 


RET 





DS IOBLK+0EFH-$ 
MODE TWO INTERUPT VECTOR FOR RESTART FIVE 
DW PERR 



CONTC 



EQU 

MVI 

CALL 

STC 

CMC 

RNZ 

CALL 

CPI 

STC 

RET 



$ 
A,0 

1ST 



;MAIN CONSOLE DEVICE NUMBER 
;TEST STATUS OF CONSOLE 



; ENSURE CARRY FALSE 

; RETURN IF NO CHARACTER TYPED 

CIN ; INPUT THE CHARACTER THAT WAS FOUND AVAILABLE 

3 ;SEE IF CHARACTER IS CONTROL-C 

;TELL SOFTWARE A CHAR WAS TYPED 

; RETURN WITH Z-FLAG PROPERLY SET 



CHI 



0110 01 CHO 



010D 01 CIN 0A50 01 CINO 0A59 01 CINl 0A5E 01 



CONTC 0AF1 01 COUO 0AE7 01 COUT OADA 01 COUTl OAEB 01 COUT2 0AC5 01 



ERTXT 0A20 01 

ISTAT 0141 01 

OST1 0A78 01 

P3 0003 00 

PERR 0A00 01 



INIT 0113 01 

OFIST 0A35 01 

OST2 0A80 01 

P4 0004 00 

PERR1 0A06 01 



IOBLK 0A00 00 

OFOST 0A63 01 

OSTAT 0144 01 

P5 0005 00 

RWCHK 012B 00 



1ST 


0A3A 


01 


ISTO 


0A3E 


01 


OFTEN 


0107 


00 


OST 


0A68 


01 


PO 


0000 


00 


PI 


0001 


00 


P6 


0006 


00 


P7 


0007 


00 


TINIT 


0A88 


01 


ZCIN 


0A4E 


01 
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BUGS FIXED IN RELEASE 5.2 

£££ 

The CR command now fails properly when given an illegal filename. 

The read-af ter-wri te check option now works with the IN command. 

Hard disk error messages are now routed to device 0. 

DOS for Single-Dens ity 

After "PRESS RETURN TO CONTINUE" appears in a directory list, device 

is now specified in the call to CIN. 

After RETURN is pressed to continue, a carriage return and a line 
feed are now echoed to the console. 

The auto start option can now be set up even without using a fresh 
copy of the DOS. 

When the auto start feature is used, the DOS herald is not 
displayed. 

DOS for Double-Density and Quad 

The DOS will now boot up properly regardless of the previous 

contents of memory at its load address. 

Directory listings will no longer cause the system to hang up for an 
undue length of time in the case of uninitialized or poorly mounted 
diskettes. 

Directory listings also will not damage any software which may have 
overlaid the latter part of the DOS, starting at 2A00H. 

OFTEN is now called during seeks on drives with fast track-to- track 
stepping. 

CQ Utility 

The proper way to compact overlapping files has never been agreed 
upon. Therefore, CO will no longer offer to proceed in the presence 
of conflicts. 

CO will no longer offer to convert a purely double density diskette 
to double-density. 

Density mismatch errors will now be handled properly in all cases. 

CF Utility 

Small files can now be copied into very large files of 512 blocks or 

more. 

Like the CR command, CF will now fail to create a new file given an 
illegal filename. 

Like the CO utlity, CF will now handle density mismatches properly 
in all cases. 
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gASJC 

The obscure bug involving the CREATE statement and its affect 

several other, seemingly unrelated statements has now been fixed. 



on 



Numeric overflows will now be detected properly when dividing very 
large numbers by very small numbers, even without a Hardware Foating 
Point Board. 

Use of user defined functions in the THEN clause of an IF statement 
will no longer prohibit the use of an ELSE clause in the same 
statement. 



The DEF statement can now be followed by additional statements on 

the same line, specifically, the problem of following a DEF 

statement with one containing an equal sign, "=", has now been 
solved . 
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NEW REL EASE 5.1 FEATURES 

This section describes the new features incorpor tated with Release 
5.1 system software. 

The format of a double sided diskette is as follows: Side A is the 
same as a single sided diskette and can be used in single sided disk 
drives. Side B holds tracks 35 through 6 9 1 with track 35 at the 
inside (opposite track 3*0, and with track 69 at the outside 
(opposite track 0). The directory is still on side A, but entries in 
it may refer to disk addresses up through 699. On a double sided, 
double-density diskette, a file which does not overlap the directory 
area may now be as large as 1392 blocks (384K bytes, or 696 
sectors). Double sided diskettes may be used in single sided drives, 
but only the data on side A may be accessed. If a file "wraps 
around" to side B, only the part of it on side A can be accessed in 
a single sided drive. Any attempt to access the remainder of such a 
file will cause an error. 

Single density DOS 5.1S now supports the CD, CF, CO, and DT utility 
programs, and has all the features of the double-density DOS except 
the OFTEN call and, of course, double-density or double sided 
operaton. In the single-density DOS, note that the JMP instruction 
at 2007H or 0107H has nothing to do with OFTEN and must not be 
altered . 



The CD, CF, CO, and DT utlity programs included with Release 5.1 
system, software are not the same as those that were supplied with 
Release 5.0 and will not work properly with that or any earlier DOS. 
These utilities will now support double sided operations when used 
with the DOS 5.1DQ. 

There is one new personalization byte, CONFG, at 2034H or 013MH in 
standard versions of Release 5.1 DOS. It tells the DOS and other 
system software two things about each of the four possible disk 
drives in the system: 

1 . The upper four bits tell which drives are double sided. 
Bits 7 down through 4 correspond to drives 1 through k , 
respectively. Each bit must be if the corresponding drive 
is single sided, or 1 to allow double sided operation of 
that drive. 

2. North Star's new, double sided drives are capable of much 
faster stepping between tracks. The lower four bits of 
CONFG tell the DOS which drives have this feature. Bits 
through 3 correspond to drives 1 through 4, respectively. 
Each bit must be if the corresponding drive can only step 
at normal speed, or 1 to take advantage of fast-stepping. 
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For example, a CONFG value of 5AH (01011010) indicates that only 
drives 2 and 4 are double sided, fast stepping drives. The proper 
CONFG value for four quad capacity drives is OFFH. DOS on factory 
master diskettes is supplied with zero i r. the CONFG byte, because 
any drive can be operated at normal speed, using side A only. 



Note that the CONFG byte exists in both single density DOS 5.1S and 
dual density DOS 5.1DQ. The CONFG byte in the single density 5.1S 
must never be changed from its original zero value, because the 
single density system supports neither double sided diskette access 
nor fast-stepping. 



The personalization process for DOS Release 5.1S is the same as that 
for Release 4 DOS, except that the jump table, after and including 
address 200DH, corresponds to the description of the Release 5.0 
jump table in the SYSTEM SOFTWARE MANUAL. In particular, such 
features as the PAGES byte, the AUTOSTART flag, and a pointer to the 
command buffer, which have been in the double-density DOS jump table 
since release 5.0, are now contained within the jump table for the 
single-density DOS, 5.1S, as well. 

The procedure for personalizing the dual density DOS remains the 

same as that given in the SYSTEM SOFTWARE MANUAL, except that the 

proper value for CONFG should be set in the new copy of DOS (in the 
workspace RAM) before it is saved on the personalized diskette. 



Beginning with Release 5.1, DOS on factory 
have the read-af ter-write option enabled. 



master diskettes will 



Two diskettes are provided with all standard HORIZON computer 
systems and MDS Micro Disk Systems: a FACTORY MASTER DISKETTE 
containing system software, and a blank to be used in preparing the 
WORKING DISKETTE as described in the SYSTEM SOFTWARE MANUAL. The 
blank included with quad-capacity systems is certified for full 
double sided operation, but the Factory Master system software 
diskette for ALL systems will remain single sided only, because 
recording upon the factory master, or removing its write protect 
tab, should never be done. 

Standard Release 5.1 BASIC is now configured to use 24K of RAM, 

starting at address 2000H or 0100H. (This now includes over 8K for 

a user program and data.) Previous releases were configured for 16K 
of RAM. 



Users of FPBASIC in single-density systems should note that the 
standard address of the floating point board was changed from DFFOH 
to EFFOH as of system software Release 5.0. At this time, a new 
personalization byte, FPBADDR (ORG + 21H), was added to FPBASIC (not 
regular BASIC). Changing FPBADDR enables FPBASIC to make use of a 
floating point board with address other that EFFOH. See 
DISCUSSION: PERSONALIZING BASIC in the SYSTEM SOFTWARE MANUAL for 
further details. 
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CHIP LOCATOR FOR 


NORTH STAR RAM 16: 










0000 


2000 


UOOO 


6000 


8000 


A000 


COOO 


E000 


HID-14C 


HlB-UJA 


1 4D-1 H C 


1HB-1H A 


1MD-1UC 


1HB-HIA 


UD-UC 


1 HB-1 1 A 


13D-13C 


13B-13A 


13D-13C 


1 3B-1 3 A 


13D-13C 


13B-13A 


13D-13C 


13B-13A 


15D-15C 


15B-15A 


15D-15C 


15B-15A 


15D-15C 


15B-15A 


15D-15C 


15B-15A 


16D-16C 


16B-16A 


16D-16C 


16B-16 A 


16D-16C 


16B-16A 


16D-16C 


16B-16A 


11D-1 1C 


11B-1 1 A 


1 1D-11C 


1 1B-1 1 A 


1 1D-11C 


1 1B-11 A 


11D-11C 


11B-11A 


10D-10C 


10B-10A 


10D-10C 


10B-10A 


10D-10C 


10B-10A 


10D-10C 


10B-10A 


12D-12C 


12B-12A 


12D-12C 


12B-12A 


12D-12C 


12B-12A 


12D-12C 


12B-12A 


17D-17C 


17B-17A 


17D-17C 


17B-17 A 


17D-17C 


17B-17A 


17D-17C 


1 7 B- 1 7 A 



MMMM*»MM 11IB-UA 14D-1HC — P 

MMMM**MM 13B-13A 13D-13C — P 

MMMM*«MM 15B-15A 15D-15C .— — P 

MMMM**MM 16B-16A 16D-16C --P 

KMMM**MM 11B-11A 11D-11C — P 

MMMM**MM 1CB-10A 10D-10C — P 

MMMM*«MM 12B-12A 12D-12C • — P 

MMMM**MM 17B-17A 17D-17C — P 

good board * board under test 

CHIP LOCATOR FOR NORTH STAR RAM 32: 

0000 2000 4000 6000 8000 A000 COOO EOOO 

— HID -UC --UB -HA --14D --14C --1MB — 14A 

--13D --13C --13B --13A --13D — 1 3C --13B — 13A 

— 15D — 1 5C — 15B --15A — 15D — 1 5C --15B — 15A 

— 16D --16C — 16B --16 A --16D --16C --16B — 16A 

-- 1 1 D --11C --11B --1 1 A --11D --11C --11B — 1 1 A 

--10D --10C --10B --10A — 10D — 10C — 10B — 10A 

__12D --12C --12B --12A — 12D --12C --12B — 12A— 

--17D --17C --17B --17A --17D — 17C — 17B — 17A 

MMMM**MM — 1 4 A — 1 1| D — 14C — 1 4 B — P 

MMMM**MM --13A --13D --1 3C --13B — P 

MMMM**MM --15A --15D --15C --15B — P 

MMMM««MM — 16A --16D --16C — 16B — P 

MMMM«*MM --11A --11D --11C --11B — P 

MMMM»«MM — 10A --10D — 10C — 10B — P 

MMMM**MM --12A --12D --12C --12B — P 

MMMM**MM — 17A --17D --17C --17B — P 

good board ~ board under test 

NOTES: 

1. Each column of the RAMTEST table represents 1.K of address space. 

2. The columns are grouped by eights; each group corresponds to one 
of the selection switches on a North Star RAM board. 

3. The first row printed is for bit 0, the last is for bit 7. 
k. Meaning of designators: 

M = good memory 

? = questionable memory 

P = PR0M/R0M 

- = no memory 



